package com.yic.module.system.service.logger;

import java.util.*;
import javax.validation.*;
import com.yic.module.system.controller.admin.logger.vo.externallog.ExternalLogCreateReqVO;
import com.yic.module.system.controller.admin.logger.vo.externallog.ExternalLogExportReqVO;
import com.yic.module.system.controller.admin.logger.vo.externallog.ExternalLogPageReqVO;
import com.yic.module.system.controller.admin.logger.vo.externallog.ExternalLogUpdateReqVO;
import com.yic.module.system.dal.dataobject.logger.ExternalLogDO;
import com.yic.framework.common.pojo.PageResult;

/**
 * 第三方API调用日志 Service 接口
 *
 * @author 系统管理员
 */
public interface ExternalLogService {

    /**
     * 创建第三方API调用日志
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createExternalLog(@Valid ExternalLogCreateReqVO createReqVO);

    /**
     * 更新第三方API调用日志
     *
     * @param updateReqVO 更新信息
     */
    void updateExternalLog(@Valid ExternalLogUpdateReqVO updateReqVO);

    /**
     * 删除第三方API调用日志
     *
     * @param id 编号
     */
    void deleteExternalLog(Long id);

    /**
     * 获得第三方API调用日志
     *
     * @param id 编号
     * @return 第三方API调用日志
     */
    ExternalLogDO getExternalLog(Long id);

    /**
     * 获得第三方API调用日志列表
     *
     * @param ids 编号
     * @return 第三方API调用日志列表
     */
    List<ExternalLogDO> getExternalLogList(Collection<Long> ids);

    /**
     * 获得第三方API调用日志分页
     *
     * @param pageReqVO 分页查询
     * @return 第三方API调用日志分页
     */
    PageResult<ExternalLogDO> getExternalLogPage(ExternalLogPageReqVO pageReqVO);

    /**
     * 获得第三方API调用日志列表, 用于 Excel 导出
     *
     * @param exportReqVO 查询条件
     * @return 第三方API调用日志列表
     */
    List<ExternalLogDO> getExternalLogList(ExternalLogExportReqVO exportReqVO);

}
